home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / programr / cxtw107.zip / CSTNWIN.H < prev    next >
C/C++ Source or Header  |  1995-07-20  |  5KB  |  112 lines
  1. /*****************************************************************************/
  2. /*
  3.     CSTNWIN.H: Defines CSTNWIN.DLL resp. CSTNWN32.DLL application interface.
  4.     This interface can be included by C or C++ code
  5.  
  6.     Copyright (C) Juergen Mueller (J.M.) 1988-1995
  7.     All rights reserved.
  8.  
  9.     You are expressly prohibited from selling this software in any form,
  10.     distributing it with another product, or removing this notice.
  11.  
  12.     THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  13.     EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THE
  14.     IMPLIED WARRANTIES OF MERCHANTIBILITY OR FITNESS FOR A PARTICULAR
  15.     PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
  16.     PROGRAM AND DOCUMENTATION IS WITH YOU.
  17.  
  18.     written by: Juergen Mueller, Aldingerstrasse 22, D-70806 Kornwestheim,
  19.                 GERMANY
  20.  
  21.     FILE       : CSTNWIN.C
  22.     REVISION   : 02-Jul-1995
  23.                  21:25:34
  24.  */
  25. /*****************************************************************************/
  26.  
  27. /* work-arounds due to the different DLL EXPORT syntax in WIN16 and WIN32 */
  28. /* NOTE: the WIN32 part is currently not supported */
  29. #ifdef _X86_                            /***** WIN32 *****/
  30.  #ifdef DLLBUILD                        /* only for DLL compilation */
  31.   #define SXTNDLLAPI    __declspec(dllexport) LONG WINAPI   /** exporting **/
  32.  #else                                  /* DLL-API for applications */
  33.   #define SXTNDLLAPI    __declspec(dllimport) LONG WINAPI   /** importing **/
  34.  #endif
  35. #else                                   /***** WIN16 *****/
  36.  #define SXTNDLLAPI     LONG WINAPI _export                 /** both **/
  37. #endif
  38.  
  39. #ifdef __cplusplus
  40. extern "C" {
  41. #endif
  42.  
  43. /* GENERAL OVERVIEW:                                                */
  44. /* the user has to declare all string arrays in his application,    */
  45. /* and pass pointers to them as function parameters                 */
  46. /* the resulting output values require a string with 300 characters */
  47. /* return value 101 means succesful, all others no success          */
  48. /* LPSTR dbfname: pointer to string with database name              */
  49.  
  50. /* get location (file line) for 'name', result is in 'location' */
  51. SXTNDLLAPI cstnGetLocation(LPSTR dbfname,               /* IN */
  52.                            LPSTR name,                  /* IN */
  53.                            LPSTR location               /* OUT [300] */
  54.                           );
  55.  
  56. /* get first name from database, result is in 'name', */
  57. /* called once before GetNextName                     */
  58. SXTNDLLAPI cstnGetFirstName(LPSTR dbfname,              /* IN */
  59.                             LPSTR name                  /* OUT [300]*/
  60.                            );
  61.  
  62. /* get next name from database, result is in 'name', */
  63. /* called after GetFirstName                         */
  64. SXTNDLLAPI cstnGetNextName(LPSTR dbfname,               /* IN */
  65.                            LPSTR name                   /* OUT [300]*/
  66.                           );
  67.  
  68. /* get first defined name from database, result is in 'name', */
  69. /* called once before GetNextDefName                          */
  70. SXTNDLLAPI cstnGetFirstDefName(LPSTR dbfname,           /* IN */
  71.                                LPSTR name               /* OUT [300]*/
  72.                               );
  73.  
  74. /* get next name defined from database, result is in 'name', */
  75. /* called after GetFirstDefName                              */
  76. SXTNDLLAPI cstnGetNextDefName(LPSTR dbfname,            /* IN */
  77.                               LPSTR name                /* OUT [300]*/
  78.                              );
  79.  
  80. /* get first called item from database, result is in 'calleditem', */
  81. /* called once before GetNextCalledItem                            */
  82. SXTNDLLAPI cstnGetFirstCalledItem(LPSTR dbfname,        /* IN */
  83.                                   LPSTR caller,         /* IN */
  84.                                   LPSTR calleditem,     /* OUT [300]*/
  85.                                   LPSTR location        /* OUT [300]*/
  86.                                  );
  87.  
  88. /* get next called item from database, result is in 'calleditem', */
  89. /* called after GetFirstCalledItem                                */
  90. SXTNDLLAPI cstnGetNextCalledItem(LPSTR dbfname,         /* IN */
  91.                                  LPSTR caller,          /* IN */
  92.                                  LPSTR calleditem,      /* OUT [300]*/
  93.                                  LPSTR location         /* OUT [300]*/
  94.                                 );
  95.  
  96. /* get first filename from database, result is in 'name', */
  97. /* called once before GetNextFile                         */
  98. SXTNDLLAPI cstnGetFirstFile(LPSTR dbfname,              /* IN */
  99.                             LPSTR filename              /* OUT [300]*/
  100.                            );
  101.  
  102. /* get next filename from database, result is in 'name', */
  103. /* called after GetFirstFile                             */
  104. SXTNDLLAPI cstnGetNextFile(LPSTR dbfname,               /* IN */
  105.                            LPSTR filename               /* OUT [300] */
  106.                           );
  107.  
  108. #ifdef __cplusplus
  109. }
  110. #endif
  111.  
  112.